代理MCP服务器
这 代理MCP服务器 充当自主AI代理的“手和眼睛”，弥合大型语言模型和本地开发环境之间的差距。它通过为文件操作、上下文读取、命令执行和文档验证提供安全、受控的访问来实现“规范驱动开发”。
🛠️ 工具参考
服务器当前公开 4个活动工具 设计有严格的安全机制，确保安全运行。
| 工具名称 | 描述 | 输入参数 | 安全机制 |
|---|---|---|---|
atomic-writer | 通过自动备份创建写入文件内容。 | path （字符串） | |
content （字符串） | • 路径横向保护：仅在项目根目录内写入。 |
• 备份：创建 .bak 覆盖之前的文件。 • 被阻止的文件：防止覆盖关键配置（例如。， mcp_manifest.json). | | fs-reader |读取相对于项目根目录的文件。 | path （字符串）|• 沙盒化的：仅限于项目根用户访问。 • 大小限制：每个文件最多5MB，以防止上下文溢出。 | | terminal-runner |执行特定的shell命令。 | command （枚举： npm, node, tsc) args （字符串\[\]） timeoutMs （数字）|• 允许名单：仅运行 npm, node，以及 tsc. • 超时：强制执行限制（默认30秒）。 • 输入净化：防止命令注入。 | | doc-fetcher |获取文档并将其转换为Markdown。 | url （字符串） timeoutMs （编号） maxBytes （数字）|• 主机允许列表：仅限于受信任的域(github.com, gitlab.com, developer.mozilla.org). • 尺寸上限：最大下载限制为1.5MB。 |
🚀 安装和设置
先决条件
- Node.js （建议使用v18或更高版本）
- npm
设置步骤
- 克隆并安装依赖关系:
npm install- 构建服务器:
npm run build这将TypeScript源代码编译为 dist/ 目录。
🔌 客户端配置
要将此服务器与MCP兼容的客户端（如Claude Desktop）一起使用，请将以下配置添加到您的设置文件中（例如。， claude_desktop_config.json).
{
"mcpServers": {
"agentic-server": {
"command": "node",
"args": [
"/ABSOLUTE/PATH/TO/mcp-agentic-jvl/dist/index.js"
]
}
}
}*注：更换 /ABSOLUTE/PATH/TO/... 带有项目目录的实际完整路径。*
🚧 路线图/即将推出
目前正在开发以下功能：
- PostgreSQL反思(
sql_db_inspector)：一种安全检查数据库模式和表结构的工具，以协助执行与数据库相关的任务。