Recall Data Omnifeeds

一个模型上下文协议 (MCP) 服务器，提供对各种数据源的访问，包括 Twitter、Substack 和 CoinGecko。此服务器使 AI 模型能够通过统一的界面与来自多个来源的数据进行交互和分析。

功能

• Twitter 集成

  • 获取用户资料和推文
  • 搜索推文和资料
  • 访问热门话题
  • 完整的写入权限（推文、点赞、转发、关注）
  • 直接消息支持
  • Grok 聊天集成

• Substack 集成

  • 获取出版物信息
  • 检索最近的文章
  • 访问文章评论
  • 搜索文章
  • 支持自定义域名和子域名

• CoinGecko 集成

  • 获取当前代币价格
  • 检索合约地址和链
  • 搜索代币
  • 获取热门代币
  • 支持免费和 Pro API 访问

与 Claude 集成

1. 安装并构建服务器：

   npm install
   npm run build
   

2. 在 Claude 中，转到 Settings -> Developer -> Add MCP endpoint

3. 添加以下配置：

   {
     "mcpServers": {
       "recall-data-omnifeeds": {
         "command": "node",
         "args": ["path to omnifeeds build they just created"],
         "env": {
           "PORT": "3008",
           "TWITTER_USERNAME": "xx",
           "TWITTER_PASSWORD": "xxx",
           "TWITTER_EMAIL": "xxx",
           "COINGECKO_API_KEY": "xxx" (optional)
         }
       }
   }
   

4. 重启 Claude

5. 验证集成：

   • 在提示输入框的右下角查找锤子图标旁边的数字
   • 通过询问以下问题测试集成：

     has anyone mentioned a cool coin lately on this list https://x.com/i/lists/1879866762147303588?
     

安装

1. 克隆存储库：

   git clone https://github.com/yourusername/recall-data-omnifeeds.git
   cd recall-data-omnifeeds
   

2. 安装依赖项：

   npm install
   

3. 创建一个包含您的 API 凭据的 .env 文件：

   # Twitter 凭据（如果需要）
   TWITTER_USERNAME=your_twitter_username
   TWITTER_PASSWORD=your_twitter_password
   TWITTER_EMAIL=your_twitter_email
   
   # CoinGecko 凭据（可选）
   COINGECKO_API_KEY=your_api_key  # 可选：启用 Pro API 功能
   

4. 构建项目：

   npm run build
   

5. 启动服务器：

   npm start
   

用法

该服务器实现了模型上下文协议 (MCP)，可以与任何 MCP 兼容的客户端一起使用。以下是一些示例调用：

Twitter 示例

// 获取用户资料
const result = await server.invoke("twitter-get-profile", {
  username: "example_user"
});

// 获取最近的推文
const result = await server.invoke("twitter-get-tweets", {
  username: "example_user",
  count: 10
});

// 搜索推文
const result = await server.invoke("twitter-search-tweets", {
  query: "example search",
  count: 20
});

Substack 示例

// 获取出版物信息
const result = await server.invoke("substack-get-publication-info", {
  substackId: "example.substack.com"
});

// 获取最近的文章
const result = await server.invoke("substack-get-recent-posts", {
  substackId: "example.substack.com",
  limit: 10
});

// 搜索文章
const result = await server.invoke("substack-search-posts", {
  substackId: "example.substack.com",
  searchTerm: "example search",
  limit: 10
});

CoinGecko 示例

// 获取代币价格
const result = await server.invoke("coingecko-get-price", {
  tokenId: "bitcoin",
  currency: "usd"
});

// 获取合约地址
const result = await server.invoke("coingecko-get-contracts", {
  tokenId: "usd-coin"
});

// 搜索代币
const result = await server.invoke("coingecko-search", {
  query: "ethereum",
  limit: 5
});

// 获取热门代币
const result = await server.invoke("coingecko-trending", {
  limit: 5
});

API 参考

Twitter 工具

工具名称	描述	参数
twitter-get-profile	获取用户资料信息	username (必需)
twitter-get-tweets	获取用户最近的推文	username (必需), count (可选, 默认: 10)
twitter-search-tweets	搜索推文	query (必需), count (可选, 默认: 20)
twitter-get-trends	获取热门话题	无
twitter-send-tweet	发送推文	text (必需)
twitter-like-tweet	点赞推文	tweetId (必需)
twitter-retweet	转发推文	tweetId (必需)
twitter-follow-user	关注用户	username (必需)

Substack 工具

工具名称	描述	参数
substack-get-publication-info	获取出版物信息	substackId (必需)
substack-get-recent-posts	获取最近的文章	substackId (必需), limit (可选, 默认: 10)
substack-search-posts	搜索文章	substackId (必需), searchTerm (必需), limit (可选, 默认: 10)
substack-get-comments	获取文章的评论	substackId (必需), postId (必需)

CoinGecko 工具

工具名称	描述	参数
coingecko-get-features	获取可用的 CoinGecko API 功能	无
coingecko-get-price	获取代币的当前价格	tokenId (必需), currency (可选, 默认: "usd")
coingecko-get-contracts	获取代币的合约地址和链	tokenId (必需)
coingecko-search	按查询搜索代币	query (必需), limit (可选, 默认: 10)
coingecko-trending	获取热门代币	limit (可选, 默认: 10)

开发

项目结构

recall-data-omnifeeds/
├── src/
│   ├── index.ts              # 主服务器入口点
│   ├── twitter-client.ts     # Twitter API 客户端
│   ├── substack-client.ts    # Substack API 客户端
│   ├── coingecko-client.ts   # CoinGecko API 客户端
│   └── tools/               # MCP 工具实现
├── dist/                    # 编译后的 JavaScript 文件
├── package.json            # 项目配置
└── tsconfig.json          # TypeScript 配置

构建

npm run build

运行测试

npm test

许可证

ISC

贡献

1. Fork 存储库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request