AINative MCP 构建指南

什么是MCP服务器？

模型上下文协议（MCP）服务器公开了AI代理（Claude Code、Cursor、Windsurf等）可以直接调用的工具。AINative的MCP服务器（zerodb-mcp-server、zerodb-memory-mcp）就是以此方式构建的。

Python — FastMCP

bash
pip install fastmcp

python

mymcpserver.py

mcp = FastMCP(my-tools)
APIKEY = akyour_key
BASE = https://api.ainative.studio

@mcp.tool()
def getusercredits() -> dict:
获取当前用户的信用额度余额。
return requests.get(
f{BASE}/api/v1/public/credits/balance,
headers={X-API-Key: API_KEY}
).json()

@mcp.tool()
def search_memory(query: str, limit: int = 5) -> dict:
语义搜索代理记忆。
return requests.post(
f{BASE}/api/v1/public/memory/v2/recall,
headers={X-API-Key: API_KEY},
json={query: query, limit: limit}
).json()

@mcp.tool()
def storememory(content: str, memorytype: str = episodic) -> dict:
在代理记忆中存储一个事实或事件。
return requests.post(
f{BASE}/api/v1/public/memory/v2/remember,
headers={X-API-Key: API_KEY},
json={content: content, memorytype: memorytype}
).json()

if name == main:
mcp.run()

bash
python mymcpserver.py

Node.js — MCP SDK

bash
npm install @modelcontextprotocol/sdk

typescript
// server.ts
import { Server } from @modelcontextprotocol/sdk/server/index.js;
import { StdioServerTransport } from @modelcontextprotocol/sdk/server/stdio.js;

const server = new Server(
{ name: my-mcp-server, version: 1.0.0 },
{ capabilities: { tools: {} } }
);

server.setRequestHandler(tools/list, async () => ({
tools: [{
name: get_credits,
description: 获取当前信用额度,
inputSchema: { type: object, properties: {} }
}]
}));

server.setRequestHandler(tools/call, async (request) => {
if (request.params.name === get_credits) {
const resp = await fetch(https://api.ainative.studio/api/v1/public/credits/balance, {
headers: { X-API-Key: process.env.AINATIVEAPIKEY! }
});
return { content: [{ type: text, text: JSON.stringify(await resp.json()) }] };
}
});

const transport = new StdioServerTransport();
await server.connect(transport);

在Claude Code中配置

json
// .claude/mcp.json
{
mcpServers: {
my-tools: {
command: python,
args: [mymcpserver.py],
env: { AINATIVEAPIKEY: akyourkey }
}
}
}

对于已发布的npm包：
json
{
mcpServers: {
my-tools: {
command: npx,
args: [my-mcp-package],
env: { AINATIVEAPIKEY: akyourkey }
}
}
}

ClawHub的SKILL.md格式

每个MCP工具都应有对应的技能文件，以便代理知道何时调用它：

markdown

工具名称

简要描述和使用示例。

放置在 .claude/skills/my-tool-name/SKILL.md。

发布到npm

bash

package.json

npm publish

参考资料

• - zerodb-mcp-server/ — 完整76工具示例（Node.js）
• zerodb-memory-mcp/ — 轻量级6工具示例（Node.js）
• src/backend/app/api/v1/endpoints/zerodb_mcp.py — 后端工具处理器
• MCP规范：https://modelcontextprotocol.io