@nahisaho/shikigami 1.1.0

package/mcp-server/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@shikigami/mcp-server",
+  "version": "1.0.0",
+  "description": "SHIKIGAMI MCP Server - Deep Research tools with DuckDuckGo search",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "shikigami-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": [
+    "mcp",
+    "shikigami",
+    "deep-research",
+    "duckduckgo",
+    "github-copilot"
+  ],
+  "author": "nahisaho",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "cheerio": "^1.0.0",
+    "node-fetch": "^3.3.2",
+    "yaml": "^2.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

package/mcp-server/shikigami.config.example.yaml

@@ -0,0 +1,93 @@
+# SHIKIGAMI Configuration
+# このファイルをプロジェクトルートに配置して設定をカスタマイズ
+#
+# ファイル名の優先順位:
+#   1. shikigami.config.yaml
+#   2. shikigami.config.yml
+#   3. .shikigami.yaml
+#   4. .shikigami.yml
+#
+# 探索場所（優先順）:
+#   1. カレントディレクトリ
+#   2. ホームディレクトリ
+#
+# 環境変数で上書き可能（環境変数が最優先）
+
+version: "1.0"
+
+# ===== 検索プロバイダー設定 =====
+search:
+  # プロバイダー選択
+  # - duckduckgo: API キー不要（デフォルト）
+  # - google: Google Custom Search API（要 API キー）
+  # - bing: Bing Search API（要 API キー）
+  # - tavily: Tavily Search API（要 API キー）
+  provider: duckduckgo
+  options:
+    # apiKey: ""  # 環境変数 SHIKIGAMI_SEARCH_API_KEY で設定推奨
+    timeout: 30000      # タイムアウト（ms）
+    maxRetries: 3       # 最大リトライ回数
+    rateLimitMs: 1500   # リクエスト間隔（ms）
+    locale: ja-JP       # 言語/地域設定
+
+# ===== ページ取得プロバイダー設定 =====
+pageFetcher:
+  # プロバイダー選択
+  # - jina: Jina AI Reader（無料枠あり、デフォルト）
+  # - firecrawl: Firecrawl（要 API キー）
+  # - browserbase: Browserbase（要 API キー）
+  provider: jina
+  options:
+    # apiKey: ""  # 環境変数 JINA_API_KEY で設定推奨
+    timeout: 30000      # タイムアウト（ms）
+    rateLimitMs: 1000   # リクエスト間隔（ms）
+    format: markdown    # 返却形式: markdown | text | html
+    waitForJS: false    # JavaScript 実行を待つか
+
+# ===== LLM プロバイダー設定 =====
+# Deep Research のサマリー生成等で使用（オプション）
+llm:
+  # プロバイダー選択
+  # - ollama: ローカル LLM（デフォルト）
+  # - openai: OpenAI API
+  # - anthropic: Anthropic Claude API
+  # - azure-openai: Azure OpenAI
+  provider: ollama
+  model: llama3.2       # 使用するモデル名
+  options:
+    endpoint: http://localhost:11434  # Ollama エンドポイント
+    # apiKey: ""        # 環境変数 OPENAI_API_KEY 等で設定推奨
+    temperature: 0.7    # 生成の多様性（0.0-1.0）
+    maxTokens: 4096     # 最大トークン数
+
+# ===== Embedding プロバイダー設定 =====
+# セマンティック検索で使用（オプション）
+embedding:
+  # プロバイダー選択
+  # - ollama: ローカル Embedding（デフォルト）
+  # - openai: OpenAI Embeddings API
+  # - huggingface: HuggingFace Inference API
+  provider: ollama
+  model: nomic-embed-text  # 使用するモデル名
+  options:
+    endpoint: http://localhost:11434
+    dimensions: 768     # ベクトル次元数
+
+# ===== キャッシュ設定 =====
+cache:
+  enabled: true         # キャッシュを有効にするか
+  ttlSeconds: 3600      # TTL（秒）= 1時間
+  maxSize: 1000         # 最大エントリ数
+  storage: memory       # memory | file
+  # filePath: .shikigami-cache.json  # file 使用時のパス
+
+# ===== ログ設定 =====
+log:
+  level: info           # debug | info | warn | error
+  output: stderr        # stderr | file
+  # filePath: shikigami.log  # file 使用時のパス
+
+# ===== カスタム設定 =====
+# 拡張用（任意のキー・値を設定可能）
+# custom:
+#   myKey: myValue

package/mcp-server/src/config/index.ts

@@ -0,0 +1,8 @@
+/**
+ * SHIKIGAMI Configuration Module
+ *
+ * @module config
+ */
+
+export * from './loader.js';
+export * from './types.js';

package/mcp-server/src/config/loader.ts

@@ -0,0 +1,246 @@
+/**
+ * SHIKIGAMI Configuration Loader
+ *
+ * REQ-NF-007: プロバイダー設定ファイル対応
+ * shikigami.config.yaml を読み込み、設定をマージ
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import * as yaml from 'yaml';
+import { ShikigamiConfig, DEFAULT_CONFIG } from './types.js';
+
+/** 設定ファイル名（優先順） */
+const CONFIG_FILENAMES = [
+  'shikigami.config.yaml',
+  'shikigami.config.yml',
+  '.shikigami.yaml',
+  '.shikigami.yml',
+];
+
+/**
+ * 設定ファイルのパスを探索
+ * @param searchPaths 探索するディレクトリパス（デフォルト: カレント、ホーム）
+ * @returns 見つかった設定ファイルパス、または null
+ */
+export function findConfigFile(searchPaths?: string[]): string | null {
+  const paths = searchPaths ?? [
+    process.cwd(),
+    process.env.HOME ?? '',
+  ].filter(Boolean);
+
+  for (const dir of paths) {
+    for (const filename of CONFIG_FILENAMES) {
+      const filePath = path.join(dir, filename);
+      if (fs.existsSync(filePath)) {
+        return filePath;
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * 深いマージを行う（配列は置換）
+ */
+function deepMerge<T extends object>(target: T, source: Partial<T>): T {
+  const result = { ...target } as T;
+
+  for (const key of Object.keys(source) as Array<keyof T>) {
+    const sourceValue = source[key];
+    const targetValue = target[key];
+
+    if (
+      sourceValue !== null &&
+      sourceValue !== undefined &&
+      typeof sourceValue === 'object' &&
+      !Array.isArray(sourceValue) &&
+      targetValue !== null &&
+      targetValue !== undefined &&
+      typeof targetValue === 'object' &&
+      !Array.isArray(targetValue)
+    ) {
+      // 両方がオブジェクトの場合、再帰マージ
+      result[key] = deepMerge(
+        targetValue as object,
+        sourceValue as object
+      ) as T[keyof T];
+    } else if (sourceValue !== undefined) {
+      // それ以外は置換
+      result[key] = sourceValue as T[keyof T];
+    }
+  }
+
+  return result;
+}
+
+/**
+ * YAML ファイルから設定を読み込み
+ * @param filePath 設定ファイルパス
+ * @returns パースされた設定
+ */
+export function loadConfigFile(filePath: string): Partial<ShikigamiConfig> {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const parsed = yaml.parse(content);
+
+  if (!parsed || typeof parsed !== 'object') {
+    throw new Error(`Invalid config file: ${filePath}`);
+  }
+
+  return parsed as Partial<ShikigamiConfig>;
+}
+
+/**
+ * 環境変数から設定を上書き
+ * SHIKIGAMI_* 形式の環境変数を読み込み
+ */
+export function loadEnvOverrides(): Partial<ShikigamiConfig> {
+  const overrides: Partial<ShikigamiConfig> = {};
+
+  // 検索プロバイダー
+  if (process.env.SHIKIGAMI_SEARCH_PROVIDER) {
+    overrides.search = {
+      provider: process.env.SHIKIGAMI_SEARCH_PROVIDER as 'duckduckgo' | 'google' | 'bing' | 'tavily',
+    };
+  }
+
+  // 検索 API キー
+  if (process.env.SHIKIGAMI_SEARCH_API_KEY) {
+    overrides.search = {
+      ...overrides.search,
+      provider: overrides.search?.provider ?? 'duckduckgo',
+      options: {
+        ...overrides.search?.options,
+        apiKey: process.env.SHIKIGAMI_SEARCH_API_KEY,
+      },
+    };
+  }
+
+  // ページ取得プロバイダー
+  if (process.env.SHIKIGAMI_PAGE_FETCHER_PROVIDER) {
+    overrides.pageFetcher = {
+      provider: process.env.SHIKIGAMI_PAGE_FETCHER_PROVIDER as 'jina' | 'firecrawl' | 'browserbase',
+    };
+  }
+
+  // Jina API キー
+  if (process.env.JINA_API_KEY || process.env.SHIKIGAMI_JINA_API_KEY) {
+    overrides.pageFetcher = {
+      ...overrides.pageFetcher,
+      provider: overrides.pageFetcher?.provider ?? 'jina',
+      options: {
+        ...overrides.pageFetcher?.options,
+        apiKey: process.env.JINA_API_KEY || process.env.SHIKIGAMI_JINA_API_KEY,
+      },
+    };
+  }
+
+  // LLM プロバイダー
+  if (process.env.SHIKIGAMI_LLM_PROVIDER) {
+    overrides.llm = {
+      provider: process.env.SHIKIGAMI_LLM_PROVIDER as 'ollama' | 'openai' | 'anthropic' | 'azure-openai',
+      model: process.env.SHIKIGAMI_LLM_MODEL ?? 'default',
+    };
+  }
+
+  // OpenAI API キー
+  if (process.env.OPENAI_API_KEY || process.env.SHIKIGAMI_OPENAI_API_KEY) {
+    overrides.llm = {
+      ...overrides.llm,
+      provider: overrides.llm?.provider ?? 'openai',
+      model: overrides.llm?.model ?? 'gpt-4o-mini',
+      options: {
+        ...overrides.llm?.options,
+        apiKey: process.env.OPENAI_API_KEY || process.env.SHIKIGAMI_OPENAI_API_KEY,
+      },
+    };
+  }
+
+  // Ollama エンドポイント
+  if (process.env.OLLAMA_HOST || process.env.SHIKIGAMI_OLLAMA_ENDPOINT) {
+    overrides.llm = {
+      ...overrides.llm,
+      provider: 'ollama',
+      model: overrides.llm?.model ?? 'llama3.2',
+      options: {
+        ...overrides.llm?.options,
+        endpoint: process.env.OLLAMA_HOST || process.env.SHIKIGAMI_OLLAMA_ENDPOINT,
+      },
+    };
+  }
+
+  // Embedding プロバイダー
+  if (process.env.SHIKIGAMI_EMBEDDING_PROVIDER) {
+    overrides.embedding = {
+      provider: process.env.SHIKIGAMI_EMBEDDING_PROVIDER as 'ollama' | 'openai' | 'huggingface',
+      model: process.env.SHIKIGAMI_EMBEDDING_MODEL ?? 'default',
+    };
+  }
+
+  // ログレベル
+  if (process.env.SHIKIGAMI_LOG_LEVEL) {
+    overrides.log = {
+      level: process.env.SHIKIGAMI_LOG_LEVEL as 'debug' | 'info' | 'warn' | 'error',
+    };
+  }
+
+  return overrides;
+}
+
+/**
+ * 設定を読み込む（ファイル + 環境変数）
+ * 優先順位: 環境変数 > 設定ファイル > デフォルト
+ *
+ * @param configPath 明示的な設定ファイルパス（省略時は自動探索）
+ * @returns マージされた設定
+ */
+export function loadConfig(configPath?: string): ShikigamiConfig {
+  let fileConfig: Partial<ShikigamiConfig> = {};
+
+  // 設定ファイルを探索・読み込み
+  const foundPath = configPath ?? findConfigFile();
+  if (foundPath) {
+    try {
+      fileConfig = loadConfigFile(foundPath);
+      console.error(`[SHIKIGAMI] Loaded config from: ${foundPath}`);
+    } catch (error) {
+      console.error(`[SHIKIGAMI] Failed to load config: ${error}`);
+    }
+  }
+
+  // 環境変数の上書きを取得
+  const envOverrides = loadEnvOverrides();
+
+  // マージ: デフォルト < ファイル < 環境変数
+  const merged = deepMerge(
+    deepMerge(DEFAULT_CONFIG, fileConfig),
+    envOverrides
+  );
+
+  return merged;
+}
+
+/** グローバル設定インスタンス（遅延初期化） */
+let _config: ShikigamiConfig | null = null;
+
+/**
+ * グローバル設定を取得
+ * 初回呼び出し時に設定をロード
+ */
+export function getConfig(): ShikigamiConfig {
+  if (!_config) {
+    _config = loadConfig();
+  }
+  return _config;
+}
+
+/**
+ * グローバル設定をリセット（テスト用）
+ */
+export function resetConfig(): void {
+  _config = null;
+}
+
+// 型のエクスポート
+export * from './types.js';

package/mcp-server/src/config/types.ts

@@ -0,0 +1,184 @@
+/**
+ * SHIKIGAMI Configuration Types
+ *
+ * REQ-NF-007: プロバイダー設定ファイル対応
+ * shikigami.config.yaml で設定をカスタマイズ可能
+ */
+
+/**
+ * 検索プロバイダー設定
+ */
+export interface SearchProviderConfig {
+  /** プロバイダー名 */
+  provider: 'duckduckgo' | 'google' | 'bing' | 'tavily';
+  /** プロバイダー固有の設定 */
+  options?: {
+    /** API キー（必要な場合） */
+    apiKey?: string;
+    /** カスタムエンドポイント */
+    endpoint?: string;
+    /** リクエストタイムアウト（ms） */
+    timeout?: number;
+    /** 最大リトライ回数 */
+    maxRetries?: number;
+    /** レート制限間隔（ms） */
+    rateLimitMs?: number;
+    /** 言語/地域設定 */
+    locale?: string;
+  };
+}
+
+/**
+ * ページ取得プロバイダー設定
+ */
+export interface PageFetcherConfig {
+  /** プロバイダー名 */
+  provider: 'jina' | 'firecrawl' | 'browserbase';
+  /** プロバイダー固有の設定 */
+  options?: {
+    /** API キー（必要な場合） */
+    apiKey?: string;
+    /** カスタムエンドポイント */
+    endpoint?: string;
+    /** リクエストタイムアウト（ms） */
+    timeout?: number;
+    /** レート制限間隔（ms） */
+    rateLimitMs?: number;
+    /** JavaScript 実行を待つか */
+    waitForJS?: boolean;
+    /** 返却形式 */
+    format?: 'markdown' | 'text' | 'html';
+  };
+}
+
+/**
+ * LLM プロバイダー設定
+ */
+export interface LLMProviderConfig {
+  /** プロバイダー名 */
+  provider: 'ollama' | 'openai' | 'anthropic' | 'azure-openai';
+  /** モデル名 */
+  model: string;
+  /** プロバイダー固有の設定 */
+  options?: {
+    /** API キー（必要な場合） */
+    apiKey?: string;
+    /** カスタムエンドポイント（Ollama等） */
+    endpoint?: string;
+    /** 生成時の温度パラメータ */
+    temperature?: number;
+    /** 最大トークン数 */
+    maxTokens?: number;
+    /** タイムアウト（ms） */
+    timeout?: number;
+  };
+}
+
+/**
+ * Embedding プロバイダー設定
+ */
+export interface EmbeddingProviderConfig {
+  /** プロバイダー名 */
+  provider: 'ollama' | 'openai' | 'huggingface';
+  /** モデル名 */
+  model: string;
+  /** プロバイダー固有の設定 */
+  options?: {
+    /** API キー（必要な場合） */
+    apiKey?: string;
+    /** カスタムエンドポイント */
+    endpoint?: string;
+    /** ベクトル次元数 */
+    dimensions?: number;
+  };
+}
+
+/**
+ * キャッシュ設定
+ */
+export interface CacheConfig {
+  /** キャッシュを有効にするか */
+  enabled: boolean;
+  /** TTL（秒） */
+  ttlSeconds?: number;
+  /** 最大キャッシュサイズ（エントリ数） */
+  maxSize?: number;
+  /** キャッシュ保存場所 */
+  storage?: 'memory' | 'file';
+  /** ファイルキャッシュのパス */
+  filePath?: string;
+}
+
+/**
+ * ログ設定
+ */
+export interface LogConfig {
+  /** ログレベル */
+  level: 'debug' | 'info' | 'warn' | 'error';
+  /** 出力先 */
+  output?: 'stderr' | 'file';
+  /** ファイル出力時のパス */
+  filePath?: string;
+}
+
+/**
+ * SHIKIGAMI 設定全体
+ */
+export interface ShikigamiConfig {
+  /** 設定ファイルバージョン */
+  version: '1.0';
+
+  /** 検索プロバイダー設定 */
+  search?: SearchProviderConfig;
+
+  /** ページ取得プロバイダー設定 */
+  pageFetcher?: PageFetcherConfig;
+
+  /** LLM プロバイダー設定 */
+  llm?: LLMProviderConfig;
+
+  /** Embedding プロバイダー設定 */
+  embedding?: EmbeddingProviderConfig;
+
+  /** キャッシュ設定 */
+  cache?: CacheConfig;
+
+  /** ログ設定 */
+  log?: LogConfig;
+
+  /** カスタム設定（拡張用） */
+  custom?: Record<string, unknown>;
+}
+
+/**
+ * デフォルト設定
+ */
+export const DEFAULT_CONFIG: ShikigamiConfig = {
+  version: '1.0',
+  search: {
+    provider: 'duckduckgo',
+    options: {
+      maxRetries: 3,
+      rateLimitMs: 1500,
+      timeout: 30000,
+    },
+  },
+  pageFetcher: {
+    provider: 'jina',
+    options: {
+      rateLimitMs: 1000,
+      timeout: 30000,
+      format: 'markdown',
+    },
+  },
+  cache: {
+    enabled: true,
+    ttlSeconds: 3600,
+    maxSize: 1000,
+    storage: 'memory',
+  },
+  log: {
+    level: 'info',
+    output: 'stderr',
+  },
+};