mcp-wiki-helper-tools

Gitリポジトリに保存されたWikiを参照するためのMCPサーバー。

Wikiを同期し、Markdownファイルをインデックス化し、CodexやVS Codeでドキュメントを一覧表示・検索・閲覧するためのツールを提供します。

機能

Related MCP server: knowledge-mcp

仕組み

1. MCPがWikiのGitリポジトリをクローンまたは更新します。

2. すべての.mdファイルを検索します。

3. メモリ内にインデックスを作成します。

4. HTTPルート/mcpでツールを提供します。

5. Wikiを定期的に更新します。

WIKI_LOCAL_PATHで定義されたフォルダはgit reset --hardで更新されます。手動で変更しないでください。変更は破棄されます。

1. サーバーの設定

MCPを実行するマシンで、プロジェクトフォルダに移動します:

cd "/caminho/para/mcp-wiki-helper"

依存関係をインストールします:

npm install

.envファイルを作成します:

cp .env.example .env

.envを入力します:

WIKI_REPOSITORY_URL=git@github.com:empresa/wiki.git
WIKI_LOCAL_PATH=./data/wiki
WIKI_BRANCH=main
WIKI_SYNC_INTERVAL_MS=1800000

MCP_HTTP_HOST=0.0.0.0
MCP_HTTP_PORT=3000
MCP_HTTP_ROUTE=/mcp

ローカルネットワークでの最初のテストを簡単にするため、MCP_API_KEYは設定しないでください。

2. サーバーの起動

コンパイル:

npm run build

起動:

npm run start:http

このターミナルは開いたままにしてください。期待されるメッセージは次のとおりです:

[MCP] HTTP ativo em http://0.0.0.0:3000/mcp

マシンのIPアドレスを確認します:

hostname -I

必要に応じて、ローカルネットワークでポートを開放します:

sudo ufw allow from 192.168.0.0/16 to any port 3000 proto tcp

3. 接続テスト

別のマシンで実行:

curl http://IP_DO_SERVIDOR:3000/health

例:

curl http://192.168.3.233:3000/health

期待される応答:

{
  "status": "ok",
  "documents": 100
}

documentsフィールドは0より大きくなければなりません。

4. Codexへの接続

Codexで:

1. Settingsを開きます。

2. MCP serversに入ります。

3. + Add serverをクリックします。

4. タイプURL/HTTPを選択します。

5. 名前wiki-helperを使用します。

6. URLのみを入力します:

http://IP_DO_SERVIDOR:3000/mcp

例:

http://192.168.3.233:3000/mcp

次のフィールドは完全に空のままにします:

• Bearer token env var

• Headers

• Headers from environment variables

認証フィールドにnoneと書かないでください。

その後:

1. サーバーを保存します。

2. wiki-helperの横のスイッチをオンにします。

3. Codexで新しい会話を開きます。

4. 送信:

Use list_documents do MCP wiki-helper e mostre os primeiros 10 documentos.

Codexが環境変数noneが存在しないと報告する場合:

1. Settings > MCP servers > wiki-helperを開きます。

2. Uninstallをクリックします。

3. URLのみを入力して再度追加します。

4. すべての認証フィールドを空のままにします。

5. VS Code/Copilotへの接続

VS Codeで:

1. Ctrl+Shift+Pを押します。

2. MCP: Open User Configurationを実行します。

3. mcp.jsonファイルに次を追加します:

{
  "servers": {
    "wiki-helper": {
      "type": "http",
      "url": "http://IP_DO_SERVIDOR:3000/mcp"
    }
  }
}

その後、MCP: List Serversを実行し、wiki-helperを選択してStart Serverを選択します。

6. 使用例

サーバーを確認:

Use a ferramenta Server do MCP wiki-helper.

ドキュメントを一覧表示:

Use list_documents do wiki-helper e mostre os primeiros 10 documentos.

名前で検索:

Use search_documents do wiki-helper para procurar "autenticação".

Wiki内を検索:

Use search_content do wiki-helper para pesquisar "JWT", com limite 5.

ドキュメントを読む:

Use read_document do wiki-helper para ler "caminho/documento.md" e faça um resumo.

よくある問題

エラーECONNREFUSED ...:80

URLにポートまたはルートがありません。常に次を使用してください:

http://IP_DO_SERVIDOR:3000/mcp

/authorizeルートが開いた

クライアントがOAuthを使用しようとしました。このMCPにはOAuthはありません。認証を削除し、BearerフィールドとHeadersフィールドを空にしてください。

MCPが接続しない

サーバーマシンで確認:

npm run start:http
ss -lntp | grep 3000

クライアントマシンで再度テスト:

curl http://IP_DO_SERVIDOR:3000/health

Wikiがドキュメントを返さない

設定したフォルダにMarkdownファイルが含まれているか確認:

find ./data/wiki -type f -name '*.md' | head

また、WIKI_REPOSITORY_URLで設定したGitリポジトリへのアクセスも確認してください。

セキュリティ

• この認証なしモードは、管理されたローカルネットワークでのみ使用してください。

• ポート3000をインターネットに直接公開しないでください。

• 外部アクセスには、HTTPS、認証、リバースプロキシを使用してください。

• .envにキーや資格情報をバージョン管理しないでください。