MCP テストサーバー
watamoo
README
MCP テストサーバー
Model Context Protocol (MCP) を使用したPythonサーバーで、OpenAIのベクトルストア機能を活用したRAG（Retrieval Augmented Generation）システムを提供します。
機能
このMCPサーバーは以下の機能を提供します：
- ベクトルDBの作成: 指定したディレクトリ内のファイル（テキスト、PDF、DOCX、マークダウン）からOpenAIのベクトルストアを構築します。
- ベクトルDBの検索: 構築したベクトルDBに対してクエリを実行し、関連性の高い情報を取得します。
必要条件
- Python 3.11以上
- OpenAI API キー
インストール方法
1. プロジェクトの初期化と仮想環境の作成
# プロジェクトを初期化
uv init mcp-test-server
cd mcp-test-server
# 仮想環境を作成して有効化
uv venv .venv
source .venv/bin/activate
2. 必要なパッケージのインストール
# 必要なパッケージをインストール
uv sync
3. 環境変数の設定
.envファイルを作成し、OpenAI APIキーを設定します：
OPENAI_API_KEY="your-api-key"
MCPサーバーのテスト（任意）
MCP Inspectorを使用したテスト
MCP Inspectorを使用して、サーバーの動作を確認できます：
# MCP Inspectorを起動
npx @modelcontextprotocol/inspector uv run server.py
MCP Inspectorでの操作手順：
- 左ペインで"Connect"を選択
- 中央のタブで"Tools"を選択
- "List Tools"を実行
- 検証したいツールを選択
- 右ペインで引数を設定して"Run Tool"を実行
- 応答内容がResultに表示されます（unicodeエスケープされるため、適宜decodeして確認）
- 終了後は、CLIでInspectorの実行を終了してポートを解放
Claudeアプリへの統合
Claudeデスクトップアプリのコンフィグファイルに以下の設定を追加します：
"test_calc": {
"command": "uv",
"args": [
"--directory",
"/abs/path/to/your/mcp-test-server",
"run",
"server.py"
]
}
/abs/path/to/your/mcp-test-serverは、実際のプロジェクトパスに置き換えてください。
設定後、Claudeアプリを再起動すると、MCPサーバーが利用可能になります。
提供されるツール
このMCPサーバーは以下のツールを提供します：
1. create_vector_db_from_directory
指定したディレクトリ内のファイルからベクトルDBを作成します。
引数:
directory_path: ファイルを検索するディレクトリのパス（必須）vector_store_name: ベクトルストアの名前（デフォルト: "local_knowledge"）file_patterns: 処理するファイルのパターン（デフォルト: [".txt", ".pdf", ".docx", ".md"]）
戻り値:
- 処理結果の情報（ステータス、メッセージ、統計情報など）
2. query_vector_db
構築したベクトルDBを検索して、関連情報を取得します。
引数:
query: 検索クエリ（必須）vector_store_id: ベクトルストアのID（必須）n_results: 返す結果の数（デフォルト: 10）
戻り値:
- 検索結果（ステータス、クエリ、結果リストなど）
Recommended Servers
Crypto Price & Market Analysis MCP Server
A Model Context Protocol (MCP) server that provides comprehensive cryptocurrency analysis using the CoinCap API. This server offers real-time price data, market analysis, and historical trends through an easy-to-use interface.
MCP PubMed Search
Server to search PubMed (PubMed is a free, online database that allows users to search for biomedical and life sciences literature). I have created on a day MCP came out but was on vacation, I saw someone post similar server in your DB, but figured to post mine.
dbt Semantic Layer MCP Server
A server that enables querying the dbt Semantic Layer through natural language conversations with Claude Desktop and other AI assistants, allowing users to discover metrics, create queries, analyze data, and visualize results.
mixpanel
Connect to your Mixpanel data. Query events, retention, and funnel data from Mixpanel analytics.
Sequential Thinking MCP Server
This server facilitates structured problem-solving by breaking down complex issues into sequential steps, supporting revisions, and enabling multiple solution paths through full MCP integration.
Nefino MCP Server
Provides large language models with access to news and information about renewable energy projects in Germany, allowing filtering by location, topic (solar, wind, hydrogen), and date range.
Vectorize
Vectorize MCP server for advanced retrieval, Private Deep Research, Anything-to-Markdown file extraction and text chunking.
Mathematica Documentation MCP server
A server that provides access to Mathematica documentation through FastMCP, enabling users to retrieve function documentation and list package symbols from Wolfram Mathematica.
kb-mcp-server
An MCP server aimed to be portable, local, easy and convenient to support semantic/graph based retrieval of txtai "all in one" embeddings database. Any txtai embeddings db in tar.gz form can be loaded
Research MCP Server
The server functions as an MCP server to interact with Notion for retrieving and creating survey data, integrating with the Claude Desktop Client for conducting and reviewing surveys.