{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_5atardsd53py","handle":"code-search-mcp","url":"https://wellknown.network/agents/code-search-mcp","links":{"self":"https://wellknown.network/agents/code-search-mcp/record.json","html":"https://wellknown.network/agents/code-search-mcp","markdown":"https://wellknown.network/agents/code-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/code-search-mcp","status":"https://wellknown.network/api/v1/agents/code-search-mcp/status","claim":"https://wellknown.network/agents/code-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/code-search-mcp/claim.json","badge":"https://wellknown.network/agents/code-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/code-search-mcp/history","tools":"https://wellknown.network/api/v1/agents/code-search-mcp/tools"},"ard":{"identifier":"urn:air::server:code-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"code-search-mcp","summary":"MCP server for indexing code repositories with SQLite","description":"# Code Search MCP\n\n基于 SQLite 的代码仓库索引 MCP 服务器\n\n## 概述\n\nCode Search MCP 是一个 MCP（Model Context Protocol）服务器，用于对代码仓库建立索引并提供强大的搜索能力。它使用 SQLite 存储索引数据，支持全文搜索（FTS5）、符号搜索和结构分析。\n\n### 核心功能\n\n- **代码索引**: 自动扫描代码仓库，提取文件、符号（函数、类、方法）和代码内容\n- **全文搜索**: 基于 SQLite FTS5 的高速全文搜索\n- **符号搜索**: 按名称搜索函数、类、方法等符号\n- **可观测性**: 内置日志系统，记录所有工具调用和性能指标\n\n## 快速开始\n\n### 安装\n\n```bash\npip install code-search-mcp\n```\n\n### 使用 MCP 客户端\n\n配置你的 MCP 客户端（如 Claude Code）：\n\n```json\n{\n  \"mcpServers\": {\n    \"code-search\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"code_search_mcp\"]\n    }\n  }\n}\n```\n\n### 基本使用\n\n```python\nfrom code_search_mcp import CodeIndexServer\n\nserver = CodeIndexServer()\n```\n\n## MCP 工具\n\n本服务提供 15 个 MCP 工具：\n\n### 1. index_repository\n\n索引整个代码仓库。\n\n```python\n{\n  \"name\": \"index_repository\",\n  \"arguments\": {\n    \"repo_path\": \"/path/to/repo\",\n    \"force_rebuild\": false\n  }\n}\n```\n\n**参数**:\n- `repo_path` (必填): 代码仓库路径\n- `force_rebuild` (可选): 是否强制重建索引，默认 false\n\n**返回**:\n```python\n{\n  \"success\": true,\n  \"stats\": {\n    \"files_indexed\": 150,\n    \"symbols\": 1200,\n    \"content_blocks\": 5000,\n    \"elapsed_seconds\": 2.5\n  }\n}\n```\n\n### 2. find_files\n\n按文件名或路径搜索文件。\n\n```python\n{\n  \"name\": \"find_files\",\n  \"arguments\": {\n    \"query\": \"test\",\n    \"extensions\": [\".py\", \".js\"],\n    \"limit\": 20\n  }\n}\n```\n\n### 3. find_symbols\n\n搜索代码符号（函数、类、方法等）。\n\n```python\n{\n  \"name\": \"find_symbols\",\n  \"arguments\": {\n    \"query\": \"calculate\",\n    \"kind\": \"function\",\n    \"limit\": 20\n  }\n}\n```\n\n### 4. find_content\n\n在代码内容中进行全文搜索。\n\n```python\n{\n  \"name\": \"find_content\",\n  \"arguments\": {\n    \"query\": \"def.*main\",\n    \"regex\": true,\n    \"file_pattern\": \"*.py\",\n    \"limit\": 20\n  }\n}\n```\n\n### 5. get_structure\n\n获取单个文件的结构信息，包括顶层符号（函数、类、变量等）。\n\n```python\n{\n  \"name\": \"get_structure\",\n  \"arguments\": {\n    \"file_path\": \"/path/to/file.py\"\n  }\n}\n```\n\n**参数**:\n- `file_path` (必填): 文件路径\n\n**返回**:\n```python\n{\n  \"structure\": {\n    \"file_path\": \"/path/to/file.py\",\n    \"functions\": [{\"name\": \"main\", \"line\": 10, \"doc\": \"主函数\"}],\n    \"classes\": [{\"name\": \"Config\", \"line\": 20, …","publisher":null,"homepage":null,"repository":null,"version":"0.7.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:code-search-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"data.database","name":"Databases","confidence":0.768,"provenance":"derived"}],"categories":["data"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"code-search-mcp","registry":"pypi","observedAt":"2026-11-09T02:25:43.706Z","publishedAt":"2026-03-18T11:07:57.254862Z","latestVersion":"0.7.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"code-search-mcp","url":"https://pypi.org/project/code-search-mcp/","firstSeenAt":"2026-09-09T12:27:03.011Z","fetchedAt":"2026-11-09T02:24:20.155Z","normalizedAt":"2026-11-09T02:24:20.155Z"}]},"firstSeenAt":"2026-09-09T12:27:03.011Z","updatedAt":"2026-11-09T02:25:43.706Z"}