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
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.
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.
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.
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.
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.
MATLAB MCP Server
Integrates MATLAB with AI to execute code, generate scripts from natural language, and access MATLAB documentation seamlessly.
Macrostrat MCP Server
Enables Claude to query comprehensive geologic data from the Macrostrat API, including geologic units, columns, minerals, and timescales through natural language.
MCP Word Counter
A Model Context Protocol server that provides tools for analyzing text documents, including counting words and characters. This server helps LLMs perform text analysis tasks by exposing simple document statistics functionality.