SHIKIGAMI MCP Server

Deep Research用のMCPサーバー。DuckDuckGo検索とJina AI Readerを使用してリアルタイムWeb検索を実行。

インストール

cd mcp-server
npm install
npm run build

ツール

search

DuckDuckGoでバッチWeb検索を実行。

{
  "query": "TypeScript best practices",
  "maxResults": 10
}

または複数クエリ:

{
  "query": ["TypeScript best practices", "TypeScript design patterns"],
  "maxResults": 5
}

visit

Webページを訪問し、内容をLLM用にクリーンなテキストとして抽出。

{
  "url": "https://example.com/article",
  "goal": "主要なポイントを抽出"
}

または複数URL:

{
  "url": ["https://example.com/1", "https://example.com/2"]
}

キャッシュシステム（v1.10.0）

検索・訪問結果をキャッシュして効率化。

キャッシュモジュール

| モジュール | 説明 | |-----------|------| | FileCacheStore | ファイルベースのキャッシュストア（LRU、TTL） | | QueryCacheManager | 検索・訪問・埋め込みのキャッシュ管理 | | SemanticCacheMatcher | 意味的類似クエリのキャッシュマッチング | | GlobalCacheStore | ユーザー横断グローバルキャッシュ |

使用例

import { getDefaultCacheManager } from './cache';

const manager = getDefaultCacheManager();

// 検索結果のキャッシュ
const cached = await manager.getSearchResult({ query: 'TypeScript' });
if (!cached.hit) {
  const results = await search('TypeScript');
  await manager.setSearchResult({ query: 'TypeScript' }, results);
}

VS Code設定

.vscode/mcp.json:

{
  "servers": {
    "shikigami": {
      "command": "node",
      "args": ["${workspaceFolder}/shikigami/mcp-server/dist/index.js"]
    }
  }
}

要件準拠

• REQ-DR-002: DuckDuckGo Web検索 ✅
• REQ-CS-004: search/visit ツール ✅
• REQ-CACHE-001: キャッシュシステム ✅ (v1.10.0)
• REQ-DICT-001: ドメイン辞書 ✅ (v1.15.0)
• REQ-PAT-001: 特許検索最適化 ✅ (v1.15.0)
• REQ-ALT-001: 代替情報源管理 ✅ (v1.15.0)
• REQ-EXT-001: 構造化データ抽出 ✅ (v1.15.0)
• REQ-PAY-001: ペイウォール検知 ✅ (v1.15.0)
• レート制限: 1.5秒間隔（DuckDuckGo）、1秒間隔（Jina AI）

v1.15.0 新機能

検索拡張

• ドメイン辞書: 専門用語の同義語展開・多言語展開
• 特許検索最適化: IPC分類コード自動推定、各特許庁向けクエリ生成

import { enhanceSearchQuery, getPatentSearchUrls } from '@nahisaho/shikigami-mcp-server';

// クエリ拡張
const enhanced = await enhanceSearchQuery('AI導入事例');
console.log(enhanced.additionalQueries);

// 特許検索URL取得
const urls = await getPatentSearchUrls('リチウムイオン電池');

訪問拡張

• ペイウォール検知: 有料記事の自動検出
• 代替情報源提案: オープンアクセス版の提案
• 構造化データ抽出: 論文・特許からのメタデータ抽出

import { enhanceVisit, getAlternativeSources } from '@nahisaho/shikigami-mcp-server';

// 完全な訪問拡張
const enhanced = await enhanceVisit(url, html, { isPaper: true });
console.log(enhanced.structuredData);
console.log(enhanced.alternativeSources);

詳細は docs/shikigami-v115-search-enhancement.prompt.md と docs/shikigami-v115-visit-enhancement.prompt.md を参照してください。

検索プロバイダー

| プロバイダー | 用途 | APIキー | |-------------|------|---------| | DuckDuckGo | Web検索 | 不要 | | Jina AI Reader | ページ内容抽出 | 不要 |