AI导哈

AI代理本地开发服务器

Agentic MCP Server 是一个为自主AI代理提供本地开发环境安全访问的服务器，支持文件操作、上下文读取、命令执行和文档验证等功能。

  • by lucastl
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 lucastl/mcp-agentic-jvl

使用说明

代理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

设置步骤

  1. 克隆并安装依赖关系:

    npm install

  2. 构建服务器:

    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)：一种安全检查数据库模式和表结构的工具，以协助执行与数据库相关的任务。

相关 MCP