Recall Data Omnifeeds

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. 创建 .env 文件并填入 API 凭据：

   # Twitter credentials (if needed)
   TWITTER_USERNAME=your_twitter_username
   TWITTER_PASSWORD=your_twitter_password
   TWITTER_EMAIL=your_twitter_email
   
   # CoinGecko credentials (optional)
   COINGECKO_API_KEY=your_api_key  # Optional: enables Pro API features
   

4. 构建项目：

   npm run build
   

5. 启动服务：

   npm start
   

用法

此服务实现了模型上下文协议（MCP），可与任何兼容 MCP 的客户端配合使用。以下是一些调用示例：

Twitter 示例

// Get a user's profile
const result = await server.invoke("twitter-get-profile", {
  username: "example_user"
});

// Get recent tweets
const result = await server.invoke("twitter-get-tweets", {
  username: "example_user",
  count: 10
});

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

Substack 示例

// Get publication info
const result = await server.invoke("substack-get-publication-info", {
  substackId: "example.substack.com"
});

// Get recent posts
const result = await server.invoke("substack-get-recent-posts", {
  substackId: "example.substack.com",
  limit: 10
});

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

CoinGecko 示例

// Get token price
const result = await server.invoke("coingecko-get-price", {
  tokenId: "bitcoin",
  currency: "usd"
});

// Get contract addresses
const result = await server.invoke("coingecko-get-contracts", {
  tokenId: "usd-coin"
});

// Search tokens
const result = await server.invoke("coingecko-search", {
  query: "ethereum",
  limit: 5
});

// Get trending tokens
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              # Main server entry point
│   ├── twitter-client.ts     # Twitter API client
│   ├── substack-client.ts    # Substack API client
│   ├── coingecko-client.ts   # CoinGecko API client
│   └── tools/               # MCP tool implementations
├── dist/                    # Compiled JavaScript files
├── package.json            # Project configuration
└── tsconfig.json          # TypeScript configuration

构建

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