🚀 故事 MCP 介绍
故事 MCP 是一个具备特定功能的项目，为用户提供了一系列服务。下面将详细介绍其安装、使用、开发等方面的内容。
🚀 快速开始
故事 MCP 能为用户带来便捷的服务体验，通过以下步骤你可以快速开启使用之旅。
📦 安装指南
故事 MCP 快速安装
按照以下步骤可以快速完成故事 MCP 的安装：
- 克隆项目仓库：
git clone https://github.com/your-repository.git cd story-mcp-hub - 安装依赖项：
uv sync - 启动故事 MCP 服务：
uv run storyscan-mcp:server.py
💻 使用示例
基础用法
在 Cursor 中添加故事 MCP 服务器
- 打开 Cursor 设置 > 特性 > MCP。
- 点击“+ 添加新 MCP 服务器”按钮。
- 填写表单：
- 选择传输类型
- 输入服务器名称
- 输入运行命令或 URL（例如：
uv --directory ~/path/to/story-mcp-hub/storyscan-mcp run server.py）
项目专用 MCP 配置
可以在 .cursor/mcp.json 文件中配置项目特定的 MCP 服务器：
{
"mcpServers": {
"storyscan-mcp": {
"command": "uv",
"args": [
"--directory",
"~/path/to/story-mcp-hub/storyscan-mcp",
"run",
"server.py"
]
},
"story-sdk-mcp": {
"command": "uv",
"args": [
"--directory",
"~/path/to/story-mcp-hub/story-sdk-mcp",
"run",
"server.py"
]
}
}
}
在 Claude 桌面版中配置 MCP 服务器
- 打开 Claude 桌面版配置文件：
code ~/Library/Application\ 支持/Claude/claude_desktop_config.json - 添加 MCP 服务器配置：
{
"mcpServers": {
"storyscan-mcp": {
"command": "uv",
"args": [
"--directory",
"~/path/to/story-mcp-hub/storyscan-mcp",
"run",
"server.py"
],
"env": {
"STORY_API_KEY": "your_story_api_key_here",
"STORYSCAN_API_ENDPOINT": "your_story_api_endpoint_here"
}
},
"story-sdk-mcp": {
"command": "uv",
"args": [
"--directory",
"~/path/to/story-mcp-hub/story-sdk-mcp",
"run",
"server.py"
],
"env": {
"WALLET_PRIVATE_KEY": "your_private_key_here",
"RPC_PROVIDER_URL": "your_rpc_provider_url_here",
"PINATA_JWT": "your_pinata_jwt_here"
}
}
}
}
📚 详细文档
故事 MCP 开发指南
如果你想参与故事 MCP 的开发，可以按照以下步骤进行：
- 创建新服务器目录
- 实现 MCP 协议
- 更新根
pyproject.toml文件中的依赖项 - 在本 README 中添加有关新服务器的信息
故事 MCP 故障排除
当遇到问题时，可以参考以下故障排除步骤：
- 验证环境变量是否正确设置
- 检查与外部 API（如 StoryScan、IPFS 等）的网络连接
- 确保使用正确的 Python 版本（3.12+）
- 检查命令语法和路径
📄 许可证
项目在 LICENSE 下开源。