Relace MCP Server
非公式 Relace MCP サーバー
非公式 — 個人のプロジェクトであり、Relace とは提携していません。
AI で構築 — すべて AI の支援(Antigravity、Codex、Cursor、Github Copilot、Windsurf)を受けて開発されました。
AI を活用したコード編集およびインテリジェントなコードベース探索ツールを提供する MCP サーバーです。
従来の手法 |
|
手動 grep、関連ファイルを見落とす | 自然言語で質問し、正確な場所を取得 |
編集により他の場所のインポートが壊れる | インポートと呼び出しチェーンを追跡 |
全書き換えでトークンを消費 | 変更内容を記述、行番号は不要 |
行番号エラーでコードが破損 | 10,000 トークン/秒以上のマージ |
機能
Fast Apply — Relace API を介して 10,000 トークン/秒以上の速度でコード編集を適用
Agentic Search — 自然言語クエリによるエージェント型コードベース探索
Agentic Retrieval — ハイブリッドなセマンティックヒントとライブコード探索(古いヒントのサポートと明示的なクラウドメンテナンス機能付き。
MCP_SEARCH_RETRIEVAL=1で有効化し、MCP_RETRIEVAL_BACKENDでバックエンドを選択)Cloud Search — クラウド同期されたリポジトリに対するセマンティックコード検索
Related MCP server: GraphHub
クイックスタート
relace バックエンド(デフォルト)を使用する場合: Relace ダッシュボード から API キーを取得し、MCP クライアントに追加してください。
~/.cursor/mcp.json
{
"mcpServers": {
"relace": {
"command": "uv",
"args": ["tool", "run", "relace-mcp"],
"env": {
"RELACE_API_KEY": "rlc-your-api-key",
"MCP_BASE_DIR": "/absolute/path/to/your/project"
}
}
}
}claude mcp add relace \
--env RELACE_API_KEY=rlc-your-api-key \
--env MCP_BASE_DIR=/absolute/path/to/your/project \
-- uv tool run relace-mcp~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"relace": {
"command": "uv",
"args": ["tool", "run", "relace-mcp"],
"env": {
"RELACE_API_KEY": "rlc-your-api-key",
"MCP_BASE_DIR": "/absolute/path/to/your/project"
}
}
}
}.vscode/mcp.json
{
"mcp": {
"servers": {
"relace": {
"type": "stdio",
"command": "uv",
"args": ["tool", "run", "relace-mcp"],
"env": {
"RELACE_API_KEY": "rlc-your-api-key",
"MCP_BASE_DIR": "${workspaceFolder}"
}
}
}
}
}~/.codex/config.toml
[mcp_servers.relace]
command = "uv"
args = ["tool", "run", "relace-mcp"]
[mcp_servers.relace.env]
RELACE_API_KEY = "rlc-your-api-key"
MCP_BASE_DIR = "/absolute/path/to/your/project"設定
変数 | 必須 | 説明 |
| ✅* | Relace ダッシュボード の API キー。Relace プロバイダーおよびクラウドツールに必須 |
| ❌ |
|
| ❌ | セマンティック検索バックエンド: |
| ❌ | 検索ヒントポリシー: |
| ❌ | ローカルインデックスの定期更新モニター(オプトイン)。固定された |
| ❌ | ローカルインデックスモニターの定期実行間隔(秒)(デフォルト: |
| ❌ | 初回のローカルインデックスチェックまでの初期遅延(秒)(デフォルト: |
| ❌ | ターンステータスのユーザーメッセージポリシー: |
| ❌ | 検索実行中の |
| ❌ | LSP 支援検索の有効化: |
| ❌ | プロジェクトルートのオーバーライド(MCP Roots → Git → ワークスペースストレージ → CWD から自動検出) |
| ❌ | ファイルログ: |
| ❌ | 設定を一元管理するための |
* APPLY_PROVIDER と SEARCH_PROVIDER の両方が Relace 以外であり、かつ MCP_RETRIEVAL_BACKEND が codanna, chunkhound, none のいずれかである場合はオプションです。
.env の使用方法、エンコーディング設定、カスタム LLM プロバイダーなどの詳細については、docs/advanced.md を参照してください。
ツール
常に利用可能: fast_apply, agentic_search。agentic_retrieval は MCP_SEARCH_RETRIEVAL=1 が必要です。クラウドツールは MCP_RETRIEVAL_BACKEND=relace の場合のみ利用可能です。index_status は relace, codanna, chunkhound で利用可能で、MCP_RETRIEVAL_BACKEND=none の場合は非表示になります。
MCP ネイティブの検出機能を使用してください: ツールには list_tools()、リソースには list_resources() を使用します。
詳細なパラメータについては、docs/tools.md を参照してください。
言語サポート
LSP ツールは、システムにインストールされている外部言語サーバーを使用します。
言語 | 言語サーバー | インストールコマンド |
Python | basedpyright | (バンドル済み) |
TypeScript/JS | typescript-language-server |
|
Go | gopls |
|
Rust | rust-analyzer |
|
ダッシュボード
操作を監視するためのリアルタイムターミナル UI。
pip install relace-mcp[tools]
relogs詳細な使用方法については、docs/dashboard.md を参照してください。
ベンチマーク
Loc-Bench コードローカリゼーションデータセットを使用して agentic_search のパフォーマンスを評価します。
git clone https://github.com/possible055/relace-mcp.git
cd relace-mcp
uv sync --extra benchmark
# Build dataset from Hugging Face
uv run --extra benchmark python -m benchmark.cli.build_locbench --output artifacts/data/raw/locbench_v1.jsonl
# Run evaluation
uv run --extra benchmark python -m benchmark.cli.run --dataset artifacts/data/raw/locbench_v1.jsonl --limit 20すべてのベンチマーク成果物は benchmark/.data/ に書き込まれます。
グリッド検索、分析ツール、メトリクスの解釈については、docs/benchmark.md を参照してください。
プラットフォームサポート
プラットフォーム | ステータス | 備考 |
Linux | ✅ 完全サポート | 主要な開発プラットフォーム |
macOS | ✅ 完全サポート | すべての機能が利用可能 |
Windows | ⚠️ 部分的 |
|
トラブルシューティング
エラーまたはメッセージ | 解決策 |
| Relace プロバイダーまたはクラウドツールを使用する場合は |
| ターゲットブロックの近くに 1~3 個の固有のアンカー行を含めてください |
| パスが存在し、 |
| ファイルが 10MB を超えています。変更を小さなファイルや編集に分割してください |
| UTF-8 以外のプロジェクトでは |
| API キーとプロバイダーの設定を確認してください |
| 後で再試行するか、リクエスト量を減らしてください |
| ネットワークアクセスを確認して再試行してください |
| マージが差分を生成できるように、より具体的なアンカーや具体的な新しい行を追加してください |
| プレースホルダーマーカーがプレースホルダーとしてのみ使用され、期待されるリテラル出力として使用されていないことを確認してください |
| 大規模な削除を伴う編集を分割するか、明示的な削除ディレクティブを使用してください |
| 変更をより小さく、より局所的な編集に分割してください |
開発
git clone https://github.com/possible055/relace-mcp.git
cd relace-mcp
uv sync --extra dev --extra benchmark
uv run pytest
uv run --extra dev --extra benchmark pytest benchmark/tests -qライセンス
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides AI-powered code intelligence for any codebase using local LLMs and vector search, enabling semantic code search, pattern analysis, and context-optimized code generation with 90% token savings.2MIT
- FlicenseNot gradedqualityCmaintenanceTransforms codebases into a knowledge graph for AI agents, enabling semantic search, impact analysis, and persistent session memory with up to 94% token savings.217
- AlicenseAqualityAmaintenanceProvides persistent memory and a codebase knowledge graph for AI coding assistants, enabling shared context across multiple tools like Claude, Cursor, and ChatGPT, with significant token reduction.532MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI coding assistants to automatically scan, store, and query API endpoints from codebases, providing instant lookup and semantic search to reduce context switching and token consumption.1MIT
Related MCP Connectors
SaaS intelligence for AI agents. 5 unified tools cover 1,000+ services with 91-96% token savings.
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Search your knowledge bases from any AI assistant using hybrid RAG.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/possible055/relace-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server