DRX-1877/dev-tools
If you are the rightful owner of dev-tools and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This is an example of a Model Context Protocol (MCP) server written in TypeScript.
Dev Tools MCP Server
这是一个使用TypeScript编写的MCP（Model Context Protocol）服务器示例。
功能
这个MCP服务器提供了以下工具：
-
hello_world - 简单的问候工具
- 参数：
name(string) - 要问候的人名
- 参数：
-
calculate - 简单的计算器
- 参数：
operation(string) - 运算类型：add, subtract, multiply, dividea(number) - 第一个数字b(number) - 第二个数字
- 参数：
-
file_info - 获取文件信息
- 参数：
path(string) - 文件路径
- 参数：
命令记忆工具
-
add_command - 保存AI生成的命令到记忆中
- 参数：
command(string) - 要保存的命令description(string) - 命令描述category(string, 可选) - 命令类别tags(string[], 可选) - 命令标签context(string, 可选) - 生成命令的上下文
- 参数：
-
search_commands - 搜索之前保存的命令
- 参数：
query(string) - 搜索关键词limit(number, 可选) - 返回结果数量限制
- 参数：
-
get_command - 根据ID获取特定命令
- 参数：
id(string) - 命令ID
- 参数：
-
get_commands_by_category - 获取指定类别的所有命令
- 参数：
category(string) - 类别名称
- 参数：
-
get_most_used_commands - 获取最常用的命令
- 参数：
limit(number, 可选) - 返回结果数量限制
- 参数：
-
get_recent_commands - 获取最近添加的命令
- 参数：
limit(number, 可选) - 返回结果数量限制
- 参数：
-
get_command_categories - 获取所有命令类别
- 参数：无
-
get_command_stats - 获取命令记忆统计信息
- 参数：无
-
update_command - 更新已保存的命令
- 参数：
id(string) - 命令IDcommand(string, 可选) - 新命令description(string, 可选) - 新描述category(string, 可选) - 新类别tags(string[], 可选) - 新标签
- 参数：
-
delete_command - 删除已保存的命令
- 参数：
id(string) - 命令ID
- 参数：
上下文记忆工具
-
add_context - 保存常用的上下文信息
- 参数：
key(string) - 简短的缩略词/关键词title(string) - 上下文标题content(string) - 完整的上下文内容category(string, 可选) - 分类tags(string[], 可选) - 标签priority(number, 可选) - 优先级 (1-5)
- 参数：
-
get_context_by_key - 根据关键词快速获取上下文
- 参数：
key(string) - 关键词
- 参数：
-
get_context_by_id - 根据ID获取上下文
- 参数：
id(string) - 上下文ID
- 参数：
-
search_contexts - 搜索上下文信息
- 参数：
query(string) - 搜索关键词limit(number, 可选) - 返回结果数量限制
- 参数：
-
get_contexts_by_category - 获取指定类别的所有上下文
- 参数：
category(string) - 类别名称
- 参数：
-
get_most_used_contexts - 获取最常用的上下文
- 参数：
limit(number, 可选) - 返回结果数量限制
- 参数：
-
get_high_priority_contexts - 获取高优先级的上下文
- 参数：
limit(number, 可选) - 返回结果数量限制
- 参数：
-
get_recent_contexts - 获取最近添加的上下文
- 参数：
limit(number, 可选) - 返回结果数量限制
- 参数：
-
get_context_categories - 获取所有上下文类别
- 参数：无
-
get_context_keys - 获取所有可用的关键词
- 参数：无
-
get_context_stats - 获取上下文记忆统计信息
- 参数：无
-
update_context - 更新已保存的上下文
- 参数：
id(string) - 上下文IDkey(string, 可选) - 新关键词title(string, 可选) - 新标题content(string, 可选) - 新内容category(string, 可选) - 新类别tags(string[], 可选) - 新标签priority(number, 可选) - 新优先级
- 参数：
-
delete_context - 删除已保存的上下文
- 参数：
id(string) - 上下文ID
- 参数：
-
smart_save - 智能保存任何内容（AI回答、prompt、代码片段等）
- 参数：
content(string) - 要保存的内容suggestedKey(string, 可选) - 建议的关键词suggestedTitle(string, 可选) - 建议的标题suggestedCategory(string, 可选) - 建议的分类suggestedTags(string[], 可选) - 建议的标签suggestedPriority(number, 可选) - 建议的优先级 (1-5)
- 参数：
安装和运行
1. 安装依赖
npm install
2. 构建项目
npm run build
3. 运行服务器
npm start
开发模式运行
npm run dev
测试
项目包含一个测试文件 test-mcp.js，用于验证MCP服务器的功能：
node test-mcp.js
测试会验证：
- 服务器初始化
- 工具列表获取
- hello_world 工具调用
- calculate 工具的各种运算
- file_info 工具的文件信息获取
- 命令记忆工具的完整功能（添加、搜索、统计等）
- 上下文记忆工具的完整功能（添加、关键词检索、搜索、统计等）
- 智能保存工具的完整功能（自动生成关键词、标题、标签等）
与AI模型集成
要将此MCP服务器与支持MCP的AI模型集成，你需要在AI模型的配置文件中添加此服务器。
示例配置（Claude Desktop）
在Claude Desktop的配置文件中添加：
{
"mcpServers": {
"dev-tools": {
"command": "node",
"args": ["/path/to/your/dev-tools/dist/server.js"],
"env": {}
}
}
}
示例配置（Cursor）
在Cursor的MCP配置中添加：
{
"mcpServers": {
"dev-tools": {
"command": "node",
"args": ["/path/to/your/dev-tools/dist/server.js"]
}
}
}
注意: 确保使用绝对路径指向编译后的 dist/server.js 文件。
故障排除
工具列表无法获取
如果Cursor无法正确获取工具列表，请检查：
- 确保项目已编译: 运行
npm run build确保生成了dist/server.js文件 - 检查路径: 确保MCP配置文件中的路径指向正确的
dist/server.js文件 - 验证服务器: 运行
node test-mcp.js或node simple-test.js验证服务器功能 - 重启Cursor: 修改MCP配置后需要重启Cursor才能生效
常见错误
- "Maximum call stack size exceeded": 通常是Zod schema转换问题，已在此版本中修复
- "Unknown tool": 确保工具名称在代码中正确定义
- 连接失败: 检查Node.js版本和依赖是否正确安装
开发
项目结构
dev-tools/
├── src/
│ ├── server.ts # MCP服务器主文件
│ ├── command-memory.ts # 命令记忆管理器
│ └── context-memory.ts # 上下文记忆管理器
├── dist/ # 编译后的JavaScript文件
├── command-memory.json # 命令记忆数据文件
├── context-memory.json # 上下文记忆数据文件
├── test-mcp.js # 测试文件
├── package.json
├── tsconfig.json
└── README.md
添加新工具
- 在
src/server.ts中定义新的参数模式：
const NewToolArgsSchema = z.object({
// 定义参数
});
- 在
tools数组中添加新工具：
{
name: "new_tool",
description: "工具描述",
inputSchema: NewToolArgsSchema,
}
- 在
CallToolRequest处理函数中添加新的case：
case "new_tool": {
const args = NewToolArgsSchema.parse(request.params.arguments);
// 实现工具逻辑
return {
content: [
{
type: "text",
text: "结果",
},
],
};
}
- 在
test-mcp.js中添加测试用例：
{
jsonrpc: "2.0",
id: 7,
method: "tools/call",
params: {
name: "new_tool",
arguments: {
// 测试参数
}
}
}
许可证
ISC