Cortexflow AI MCP

MCPAI代理

提供方 CortexFlow-AI · 包名 vitest

AI代理 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

一个用于构建具有HTTP流功能的MCP(模型上下文协议)服务器的基础模板,提供生产就绪的实现、全面的测试覆盖和清晰的文档。

一句话选型结论

按资料字段整理

Cortexflow AI MCP 属于AI代理类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 1 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量1暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

MCP协议TypeScript本地部署HTTP流服务器模板生产就绪

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx vitest run tests/unit/tools/hello-tool.test.ts

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Cortexflow AI MCP当前 1 stdio · 本地进程 本地部署 有 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方CortexFlow-AI上游标注的维护方 CortexFlow-AI
分类AI代理本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时vitest · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

11.4 KB
来自项目仓库与上游目录的原文,未做删改

HTTP流MCP模板

用于构建具有HTTP流功能的MCP(模型上下文协议)服务器的基础结构。

概述

此模板使用Streamable HTTP传输协议提供了一个完整的、生产就绪的MCP服务器实现。它包括Hello world功能、全面的测试覆盖率和清晰的文档,可作为开发人员构建自己的MCP服务器的起点。

该模板实现了MCP协议版本2025-06-18,并遵循所有安全最佳实践,使其适用于开发和生产使用。

特性

  • ✅ MCP协议2025-06-18合规性 -全面实施最新的MCP规范
  • ✅ HTTP流式传输 -POST/GET支持,可选服务器发送事件(SSE)
  • ✅ Hello world工具实现 -带有参数处理的完整示例工具
  • ✅ 全面的测试覆盖率 -通过单元和集成测试,线路覆盖率达到95%以上
  • ✅ 具有严格模式的TypeScript -完全类型安全和现代JavaScript功能
  • ✅ 安全最佳实践 -源验证、本地主机绑定、输入净化
  • ✅ 可扩展架构 -易于添加新工具和自定义行为
  • ✅ 生产就绪 -错误处理、日志记录、正常关机和配置

快速开始

先决条件

  • Node.js 18+(推荐:Node.js 20 LTS)
  • npm 9+或纱1.22+

安装

  1. 克隆或下载模板:```bash
    git clone my-mcp-server
    cd my-mcp-server

1. **安装依赖项:**```bash
npm install
  1. 启动开发服务器:```bash
    npm run dev

服务器将于启动 `http://127.0.0.1:3000` 默认情况下。

### 验证安装

用一个简单的HTTP请求测试服务器:```bash
# Test server health
curl http://127.0.0.1:3000/mcp

# Test MCP initialization (requires proper MCP client)
curl -X POST http://127.0.0.1:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "initialize",
"params": {
"protocolVersion": "2025-06-18",
"capabilities": {},
"clientInfo": {"name": "test-client", "version": "1.0.0"}
}
}'

配置

环境变量

可以使用环境变量配置服务器:```bash

Server configuration

export MCP_PORT=3000 # Server port (default: 3000)
export MCP_HOST=127.0.0.1 # Server host (default: 127.0.0.1)

Start server with custom configuration

npm start


### 程序化配置```typescript
import { MCPServer, createDefaultConfig } from './src/index.js';

const config = {
...createDefaultConfig(),
port: 8080,
host: '0.0.0.0',  // WARNING: Only use in secure environments
allowedOrigins: ['localhost', '127.0.0.1', 'myapp.com'],
serverInfo: {
name: 'my-custom-mcp-server',
version: '2.0.0'
}
};

const server = new MCPServer(config);
await server.start();

配置选项

选项 类型 默认值 描述
port number 3000 HTTP服务器端口
host string '127.0.0.1' 服务器绑定地址
allowedOrigins string[] ['localhost','127.0.0.1'] 允许的Origin标头
protocolVersion string '2025-06-18' MCP协议版本
serverInfo.name string “http流mcp模板” 服务器名称
serverInfo.version string “1.0.0” 服务器版本

用法

使用Hello工具

该模板包括一个Hello工具,用于演示基本的MCP功能:```bash

List available tools

curl -X POST http://127.0.0.1:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/list"
}'

Call Hello tool without parameters

curl -X POST http://127.0.0.1:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "hello",
"arguments": {}
}
}'

Call Hello tool with name parameter

curl -X POST http://127.0.0.1:3000/mcp \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 4,
"method": "tools/call",
"params": {
"name": "hello",
"arguments": {"name": "Alice"}
}
}'


### 添加自定义工具

1. **创建新的工具类:**```typescript
// src/tools/my-tool.ts
import { ToolImplementation, ToolResult } from '../types/index.js';

export class MyTool implements ToolImplementation {
name = 'my-tool';
description = 'My custom tool';
inputSchema = {
type: 'object',
properties: {
input: { type: 'string' }
}
};

async execute(args: any): Promise {
return {
content: [{ type: 'text', text: `Processed: ${args.input}` }],
isError: false
};
}
}
  1. 注册工具:```typescript
    // In your server setup
    import { MyTool } from './tools/my-tool.js';

const server = new MCPServer(config);
server.registerTool(new MyTool());
await server.start();


## 发展

### 可用脚本

|脚本|描述|
|--------|-------------|
| `npm run dev` |使用热重新加载启动开发服务器|
| `npm run build` |将TypeScript构建为JavaScript|
| `npm start` |启动生产服务器|
| `npm test` |运行所有测试|
| `npm run test:watch` |在监视模式下运行测试|
| `npm run test:coverage` |使用覆盖率报告运行测试|
| `npm run lint` |检查代码样式|
| `npm run lint:fix` |修复代码风格问题|
| `npm run format` |使用Prettier格式化代码|

### 项目结构```
├── src/
│   ├── types/              # TypeScript type definitions
│   │   ├── index.ts        # Main type exports
│   │   ├── mcp.ts          # MCP protocol types
│   │   └── server.ts       # Server configuration types
│   ├── protocol/           # MCP protocol implementation
│   │   ├── errors.ts       # Error handling and standard error codes
│   │   ├── initialization.ts # MCP initialization handshake
│   │   └── jsonrpc.ts      # JSON-RPC message handling
│   ├── transport/          # HTTP transport layer
│   │   ├── http-server.ts  # Main HTTP server implementation
│   │   ├── content-negotiation.ts # Accept header handling
│   │   └── security-middleware.ts # Origin validation & security
│   ├── server/             # MCP server orchestration
│   │   ├── mcp-server.ts   # Main server class
│   │   └── tools-handler.ts # Tool request routing
│   ├── tools/              # Tool implementations
│   │   ├── hello-tool.ts   # Hello world tool example
│   │   ├── registry.ts     # Tool registration and management
│   │   └── index.ts        # Tool exports
│   └── index.ts            # Main entry point and exports
├── tests/
│   ├── unit/               # Unit tests
│   └── integration/        # Integration tests
├── examples/               # Usage examples
├── dist/                   # Compiled JavaScript (generated)
└── coverage/               # Test coverage reports (generated)

测试

该模板包括全面的测试覆盖率:```bash

Run all tests

npm test

Run tests with coverage

npm run test:coverage

Run tests in watch mode during development

npm run test:watch

Run specific test file

npx vitest run tests/unit/tools/hello-tool.test.ts


### 代码质量

该项目使用ESLint和Prettier来提高代码质量:```bash
# Check for linting issues
npm run lint

# Automatically fix linting issues
npm run lint:fix

# Format code
npm run format

生产部署

生产大楼```bash

Build the project

npm run build

Start production server

npm start


### Docker部署

创建一个 `Dockerfile`:```dockerfile
FROM node:20-alpine

WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

COPY dist/ ./dist/
EXPOSE 3000

CMD ["npm", "start"]

构建并运行:```bash
docker build -t my-mcp-server .
docker run -p 3000:3000 my-mcp-server


### 流程管理

对于生产部署,使用PM2这样的流程管理器:```bash
# Install PM2
npm install -g pm2

# Start with PM2
pm2 start dist/index.js --name mcp-server

# Monitor
pm2 status
pm2 logs mcp-server

安全考虑

默认安全功能

  • 本地主机绑定:默认情况下,服务器绑定到127.0.0.1
  • 原产地验证:验证Origin标头以防止DNS重新绑定攻击
  • 输入净化:所有工具输入都经过验证和消毒
  • 错误处理:防止通过错误消息泄露信息

生产安全

对于生产部署:

  1. 使用HTTPS:在生产环境中始终使用TLS
  2. 防火墙:限制对MCP端口的访问
  3. 认证:添加身份验证中间件(参见示例)
  4. 速率限制:对工具调用实施速率限制
  5. 监控:添加日志记录和监控

添加身份验证```typescript

// Example authentication middleware
import { MCPServer } from './src/index.js';

const server = new MCPServer(config);

// Add authentication hook (implement based on your needs)
server.addAuthenticationHook(async (request) => {
const token = request.headers.authorization;
if (!isValidToken(token)) {
throw new Error('Unauthorized');
}
});


## 故障排除

### 常见问题

#### 服务器无法启动

**问题**: `Error: listen EADDRINUSE :::3000`
**解决方案**:端口3000已在使用中。要么:

- 使用端口3000停止进程: `lsof -ti:3000 | xargs kill`
- 使用其他端口: `MCP_PORT=3001 npm start`

**问题**: `Error: listen EACCES :::80`
**解决方案**:1024以下的端口需要root权限。使用端口3000+或使用sudo运行(不推荐)。

#### 连接被拒绝

**问题**: `curl: (7) Failed to connect to 127.0.0.1 port 3000: Connection refused`
**解决方案**:

- 确保服务器正在运行: `npm run dev`
- 检查服务器日志中的启动错误
- 验证端口配置

#### 原产地验证错误

**问题**: `Error: Invalid Origin header`
**解决方案**:将您的域名添加到 `allowedOrigins` 在配置中:```typescript
const config = {
...createDefaultConfig(),
allowedOrigins: ['localhost', '127.0.0.1', 'yourdomain.com']
};

未找到工具

问题: Method not found: tools/call
解决方案:

  • 在调用工具之前,确保服务器已初始化
  • 检查工具是否正确登记
  • 验证请求中的工具名称

JSON-RPC错误

问题: Parse error 或 Invalid Request
解决方案:

  • 确保内容类型为 application/json
  • 验证JSON语法
  • 包含必需的JSON-RPC字段(jsonrpc, method, id)

调试模式

启用调试日志记录:```bash

Set debug environment variable

DEBUG=mcp:* npm run dev

Or in code

process.env.DEBUG = 'mcp:*';


### 健康检查

服务器提供健康检查端点:```bash
# Basic health check
curl http://127.0.0.1:3000/mcp

# Server statistics
curl -X POST http://127.0.0.1:3000/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"server/stats"}'

性能问题

如果遇到性能问题:

  1. 检查测试覆盖率: npm run test:coverage
  2. 配置文件内存使用情况:使用Node.js --inspect 旗帜
  3. 监控工具执行时间:检查服务器日志
  4. 验证输入模式:确保有效验证

获取帮助

  1. 检查日志:服务器日志包含详细的错误信息
  2. 审查测试用例:测试证明了预期的行为
  3. 参考MCP规范: MCP协议文件
  4. 查看示例:参见 examples/ 使用模式目录

文档

  • 需求 -详细的功能要求
  • 设计 -架构和设计决策
  • 实施任务 -开发任务分解
  • MCP协议规范 -MCP官方文件

贡献

  1. 分叉存储库
  2. 创建要素分支: git checkout -b feature/my-feature
  3. 进行更改并添加测试
  4. 确保测试通过: npm test
  5. 检查代码质量: npm run lint
  6. 提交更改: git commit -am 'Add my feature'
  7. 推送到分支: git push origin feature/my-feature
  8. 创建拉取请求

许可证

MIT许可证-有关详细信息,请参阅许可证文件。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
Cortexflow AI MCP 怎么安装?

在客户端按下面的安装命令接入:npx vitest run tests/unit/tools/hello-tool.test.ts。对应的包名是 vitest。装完在客户端配置里引用同一个包或端点。

Cortexflow AI MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Cortexflow AI MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Cortexflow AI MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Cortexflow AI MCP 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 服务器模板、生产就绪、TypeScript、JavaScript。具体工具清单以官方文档为准。

Cortexflow AI MCP 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Cortexflow AI MCP 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。